================================================================
                       	PARKING SENSOR
                  GTA SAN ANDREAS MULTIPLAYER
================================================================

MOD INFORMATION
----------------------------------------------------------------
Mod Name       : Parking Sensor
Version        : 5.2.4
Platform       : GTA San Andreas PC / SA-MP
Mod Type       : CLEO Script (.cs)
Developer      : Ottibonynyo (whoisfeb) https://youtube.com/@ottibonynyo?si=4vKORN7RUiGRKMkt
Release Status : Stable Release
Development    : Active
Language       : Indonesian
Requirements   : CLEO 4.3 + SAMPFUNCS 5.4.1

================================================================
1. DESCRIPTION
================================================================

Parking Sensor merupakan modifikasi untuk GTA San Andreas
Multiplayer (SA-MP) yang menghadirkan fitur sensor parkir
kendaraan dengan tampilan visual dan peringatan suara.

Mod ini dirancang untuk membantu pemain mengetahui keberadaan
objek atau penghalang di sekitar kendaraan ketika sedang
melakukan manuver parkir.

Sistem sensor menggunakan pemeriksaan raycast untuk mendeteksi
penghalang pada empat arah kendaraan, yaitu depan, belakang,
kiri, dan kanan.

Ketika penghalang terdeteksi, indikator HUD akan menampilkan
warna sesuai tingkat kedekatan objek dan memberikan peringatan
suara.

Mod ini juga dilengkapi HUD Editor yang memungkinkan pemain
mengatur posisi dan ukuran tampilan secara langsung di dalam
game tanpa perlu mengubah source code.

Parking Sensor dikembangkan menggunakan CLEO Script dan
tidak membutuhkan MoonLoader maupun ModLoader.


================================================================
2. MAIN FEATURES
================================================================

[01] FOUR-DIRECTION PARKING SENSOR

Sistem mendeteksi penghalang pada empat arah kendaraan:

- Front Sensor : Sensor bagian depan kendaraan.
- Rear Sensor  : Sensor bagian belakang kendaraan.
- Left Sensor  : Sensor bagian kiri kendaraan.
- Right Sensor : Sensor bagian kanan kendaraan.

Setiap arah mempunyai status pendeteksian tersendiri.


[02] REAL-TIME OBSTACLE DETECTION

Sensor melakukan pemeriksaan penghalang menggunakan raycast
ketika kendaraan memenuhi kondisi pengoperasian.

Pemeriksaan mempertimbangkan dimensi model kendaraan sebagai
titik awal pendeteksian.

Sensor dapat mendeteksi jenis penghalang yang didukung oleh
pemeriksaan collision pada GTA San Andreas.

Ketepatan pendeteksian bergantung pada geometri dan collision
objek di lingkungan permainan.


[03] COLOR INDICATOR SYSTEM

Tampilan sensor menggunakan tiga warna utama:

GREEN (HIJAU)
- Tidak ada penghalang terdeteksi dalam jangkauan.
- Kondisi sensor normal.

YELLOW (KUNING)
- Penghalang terdeteksi pada jarak menengah.
- Pengemudi disarankan mulai berhati-hati.

RED (MERAH)
- Penghalang terdeteksi pada jarak dekat.
- Pengemudi disarankan segera mengurangi pergerakan kendaraan.

Setiap indikator arah dapat berubah warna berdasarkan hasil
pendeteksian sensor masing-masing.


[04] AUDIO PARKING WARNING

Mod menyediakan peringatan suara berdasarkan tingkat
kedekatan penghalang.

WARNING LEVEL 1
- Penghalang terdeteksi pada jarak menengah.
- Menggunakan bunyi peringatan lambat.

WARNING LEVEL 2
- Penghalang terdeteksi pada jarak dekat.
- Menggunakan bunyi peringatan cepat.

Peringatan suara menggunakan event audio GTA San Andreas.

Suara tidak diputar selama mode HUD Editor aktif.


[05] CUSTOM PARKING SENSOR HUD

Tampilan HUD menggunakan tekstur khusus dari PARKHUD.txd.

Elemen HUD terdiri atas:

- Background panel.
- Ilustrasi kendaraan.
- Indikator sensor depan.
- Indikator sensor belakang.
- Indikator sensor kiri.
- Indikator sensor kanan.

Tekstur dimuat menggunakan sistem TXD GTA San Andreas.


[06] IN-GAME HUD EDITOR

Pemain dapat mengatur tampilan HUD langsung melalui game.

Pengaturan yang tersedia:

- Memindahkan HUD ke atas.
- Memindahkan HUD ke bawah.
- Memindahkan HUD ke kiri.
- Memindahkan HUD ke kanan.
- Memperbesar ukuran HUD.
- Memperkecil ukuran HUD.

Mode editor menampilkan pratinjau HUD meskipun pemain tidak
sedang berada di dalam kendaraan.


[07] AUTOMATIC HUD CONFIGURATION SAVE

Posisi dan skala HUD disimpan melalui file konfigurasi:

CLEO\ParkingSensor.ini

Pengaturan akan dimuat kembali ketika mod dijalankan.

Pengguna tidak perlu mengatur ulang HUD setiap kali masuk
ke dalam game.


[08] HUD RESET SYSTEM

Pemain dapat mengembalikan posisi dan ukuran HUD ke
pengaturan awal menggunakan perintah /parkingsensorreset.


[09] SENSOR ON/OFF SYSTEM

Sistem sensor dapat diaktifkan atau dinonaktifkan melalui
perintah /parkingsensor.

Status awal sensor dalam source adalah aktif.


[10] LOW-SPEED PARKING OPERATION

Pemeriksaan sensor dirancang untuk digunakan saat kendaraan
bergerak dengan kecepatan rendah.

Dalam source, pemeriksaan dilakukan ketika nilai kecepatan
yang dibaca game berada di bawah 15.0.

Sistem tidak dimaksudkan sebagai alat bantu berkendara
pada kecepatan tinggi.


================================================================
3. SYSTEM REQUIREMENTS
================================================================

Untuk menjalankan mod ini, diperlukan:

- GTA San Andreas PC versi 1.0 US.
- SA-MP yang kompatibel.
- CLEO 4.3.
- SAMPFUNCS 5.4.1.
- File ParkingSensor.cs.
- File PARKHUD.txd.

Sanny Builder diperlukan apabila pengguna ingin mengubah
atau mengompilasi source code.

MoonLoader       : NOT REQUIRED
ModLoader        : NOT REQUIRED
Internet Service : Tidak diperlukan oleh fitur sensor,
                   tetapi SA-MP memerlukan koneksi server.


================================================================
4. INSTALLATION GUIDE
================================================================

STEP 1 - PREPARE GTA SAN ANDREAS

Pastikan GTA San Andreas PC versi 1.0 US sudah terpasang
dan dapat dijalankan dengan baik.

Pastikan SA-MP, CLEO, dan SAMPFUNCS telah terinstal.


STEP 2 - INSTALL CLEO SCRIPT

Salin file:

Parking-Sensor.cs

Ke direktori:

GTA San Andreas\CLEO\


STEP 3 - INSTALL HUD TEXTURE

Salin file:

PARKHUD.txd

Ke direktori:

GTA San Andreas\models\txd\

IMPORTANT:
Pastikan PARKHUD.txd berada di folder models\txd,
bukan langsung di folder models.


STEP 4 - RUN THE GAME

Jalankan GTA San Andreas Multiplayer.

Masuk ke server SA-MP seperti biasa.


STEP 5 - CONFIGURE HUD

Buka chat SA-MP dan ketik:

/parkingsensoredit

Gunakan tombol panah untuk memindahkan HUD.

Gunakan tombol + atau - untuk mengubah ukuran HUD.

Setelah selesai, ketik kembali:

/parkingsensoredit

Pengaturan posisi dan skala akan tersimpan.


STEP 6 - TEST PARKING SENSOR

Masuk ke kendaraan dan kemudikan secara perlahan.

Dekatkan kendaraan ke objek atau penghalang.

Perhatikan indikator sensor dan peringatan suara.


================================================================
5. AVAILABLE COMMANDS
================================================================

/parkingsensor

Mengaktifkan atau menonaktifkan Parking Sensor.

ON  : Sensor aktif.
OFF : Sensor tidak melakukan pemeriksaan normal.


/parkingsensoredit

Mengaktifkan atau menonaktifkan mode HUD Editor.

Ketika mode editor aktif:
- HUD ditampilkan sebagai pratinjau.
- HUD dapat dipindahkan.
- Ukuran HUD dapat diubah.
- Peringatan suara dinonaktifkan selama editor aktif.


/parkingsensorreset

Mengembalikan posisi dan skala HUD ke nilai awal
yang ditentukan dalam source.


================================================================
6. HUD EDITOR CONTROLS
================================================================

KEYBOARD CONTROL

Arrow Up       : Move HUD Up
Arrow Down     : Move HUD Down
Arrow Left     : Move HUD Left
Arrow Right    : Move HUD Right

Plus (+) / (=) : Increase HUD Scale
Minus (-)      : Decrease HUD Scale

COMMAND

/parkingsensoredit    : Enable / Disable HUD Editor

HUD position and scale are automatically saved.


================================================================
7. PARKING SENSOR DETECTION RANGE
================================================================

DEFAULT DETECTION DISTANCE

NORMAL RANGE
Distance : Beyond 4.0 game units
Indicator: GREEN
Warning  : No obstacle warning

CAUTION RANGE
Distance : Approximately 1.5 - 4.0 game units
Indicator: YELLOW
Warning  : Slow warning sound

DANGER RANGE
Distance : Approximately 0 - 1.5 game units
Indicator: RED
Warning  : Fast warning sound


IMPORTANT NOTES:

Jarak tersebut merupakan panjang pemeriksaan raycast
dari titik awal sensor yang dihitung berdasarkan dimensi
kendaraan.

Jarak bukan pengukuran presisi dari permukaan bumper.

Pemeriksaan sensor tidak selalu dapat mendeteksi seluruh
objek karena bergantung pada collision dan arah raycast.

Empat sensor menggunakan prinsip pemeriksaan yang sama,
tetapi arahnya berbeda.


================================================================
8. SENSOR SOUND SYSTEM
================================================================

Sistem suara menggunakan event audio bawaan GTA San Andreas.

CAUTION WARNING
- Menggunakan audio event 1057.
- Peringatan dengan interval lebih lambat.

DANGER WARNING
- Menggunakan audio event 1056.
- Peringatan dengan interval lebih cepat.

Interval pemeriksaan suara dalam source menggunakan nilai
ambang 550 dan 170 pada variabel penghitung.

Catatan:
Dalam source yang digunakan, variabel penghitung suara
diinisialisasi tetapi belum terlihat ditingkatkan secara
berkala. Oleh karena itu, bunyi periodik belum dapat
dipastikan berfungsi sebagaimana yang diharapkan tanpa
perbaikan atau pengujian tambahan.


================================================================
9. HUD CONFIGURATION
================================================================

Configuration File:

GTA San Andreas\CLEO\ParkingSensor.ini

DEFAULT CONFIGURATION:

[HUD]
X=560.0
Y=105.0
Scale=0.65

DESCRIPTION:

X
Mengatur posisi horizontal HUD.

Y
Mengatur posisi vertikal HUD.

Scale
Mengatur ukuran keseluruhan HUD.

Semakin besar nilai Scale, semakin besar tampilan HUD.

Semakin kecil nilai Scale, semakin kecil tampilan HUD.

DEFAULT SCALE : 0.65

Batas skala dalam source editor:

Minimum sekitar : 0.40
Maximum sekitar : 1.50

Batas dan langkah perubahan skala dapat disesuaikan
melalui source code.

Nilai minimum dan maksimum merupakan ambang pemeriksaan
editor, sehingga hasil akhir dapat berbeda sedikit
bergantung pada langkah perubahan skala.

================================================================
10. FILE STRUCTURE
================================================================

GTA San Andreas
|
|-- CLEO
|   |
|   |-- ParkingSensor.cs
|   |
|   |-- ParkingSensor.ini
|       (Created when settings are saved)
|
|-- models
|   |
|   |-- txd
|       |
|       |-- PARKHUD.txd
|
|-- README.txt
    (Documentation / optional)


================================================================
11. TROUBLESHOOTING
================================================================

PROBLEM 1:
Parking Sensor HUD tidak muncul.

SOLUTION:
- Pastikan ParkingSensor.cs terpasang di folder CLEO.
- Pastikan PARKHUD.txd berada di models\txd.
- Pastikan CLEO dan SAMPFUNCS kompatibel.
- Gunakan /parkingsensoredit untuk menampilkan HUD.
- Periksa log jika script gagal dijalankan.


PROBLEM 2:
Perintah /parkingsensor tidak berfungsi.

SOLUTION:
- Pastikan SAMPFUNCS sudah terpasang.
- Pastikan mod berhasil dimuat.
- Periksa kemungkinan konflik dengan script lain.


PROBLEM 3:
HUD terlalu besar atau terlalu kecil.

SOLUTION:
- Gunakan /parkingsensoredit.
- Tekan + atau - untuk mengubah ukuran.
- Gunakan /parkingsensorreset jika diperlukan.


PROBLEM 4:
HUD berada di posisi yang salah.

SOLUTION:
- Gunakan /parkingsensoredit.
- Pindahkan HUD menggunakan tombol panah.
- Pastikan pengaturan tersimpan.


PROBLEM 5:
Indikator sensor tidak berubah warna.

SOLUTION:
- Pastikan sedang mengemudikan kendaraan.
- Dekatkan kendaraan secara perlahan ke penghalang.
- Pastikan kecepatan memenuhi kondisi pemeriksaan.
- Periksa apakah objek mempunyai collision yang sesuai.


PROBLEM 6:
Sensor tidak mengeluarkan suara.

SOLUTION:
- Pastikan /parkingsensor aktif.
- Pastikan suara game tidak dimatikan.
- Periksa bagian SOUND_SYSTEM pada source.
- Pastikan penghitung interval suara bekerja dengan benar.


PROBLEM 7:
File PARKHUD.txd tidak terbaca.

SOLUTION:
- Periksa nama file PARKHUD.txd.
- Periksa lokasi models\txd\PARKHUD.txd.
- Pastikan texture dictionary memuat nama:
  panel, car, front, rear, left, right.


================================================================
12. KNOWN LIMITATIONS
================================================================

1. Sensor menggunakan raycast pada empat arah utama,
   bukan pemindaian seluruh area di sekitar kendaraan.

2. Beberapa objek mungkin tidak terdeteksi karena
   perbedaan collision atau geometri.

3. Ketepatan jarak bergantung pada dimensi kendaraan.

4. HUD tidak menggunakan sistem radar 3D penuh.

5. Tampilan dan ukuran HUD dapat berbeda pada resolusi
   layar yang berbeda.

6. Mod dirancang untuk GTA San Andreas PC dan SA-MP
   dengan dependensi yang disebutkan.

7. Sistem suara periodik memerlukan pemeriksaan lebih
   lanjut terhadap logika penghitung interval.

8. Mod belum dinyatakan kompatibel dengan seluruh
   konfigurasi GTA San Andreas atau server SA-MP.


================================================================
14. UNINSTALLATION GUIDE
================================================================

Untuk menghapus mod:

1. Tutup GTA San Andreas.

2. Hapus file:

   CLEO\ParkingSensor.cs

3. Hapus file konfigurasi jika tidak diperlukan:

   CLEO\ParkingSensor.ini

4. Hapus file tekstur:

   models\txd\PARKHUD.txd

   Hapus file tekstur hanya apabila tidak digunakan
   oleh mod lain.

5. Jalankan kembali GTA San Andreas.


================================================================
15. DEVELOPER & CREDITS
================================================================

PROJECT NAME:
Parking Sensor

DEVELOPER / AUTHOR:
Ottibonynyo (whoisfeb)

SCRIPTING LANGUAGE:
CLEO Script

TARGET GAME:
Grand Theft Auto: San Andreas
San Andreas Multiplayer (SA-MP)

DEPENDENCIES:
CLEO
SAMPFUNCS

SPECIAL THANKS:
- Komunitas modding GTA San Andreas.
- Pengembang dan kontributor CLEO.
- Pengembang dan kontributor SAMPFUNCS.
- Komunitas Sanny Builder.

Additional credits for texture assets or other contributors
should be added when applicable.


================================================================
16. CHANGELOG
================================================================

VERSION 5.0
----------------------------------------------------------------

[FEATURES]
+ Four-direction parking sensor.
+ Front obstacle detection.
+ Rear obstacle detection.
+ Left obstacle detection.
+ Right obstacle detection.
+ Green, yellow, and red indicators.
+ HUD texture rendering.
+ Parking warning audio logic.
+ /parkingsensor command.
+ /parkingsensoredit command.
+ /parkingsensorreset command.
+ In-game HUD movement.
+ In-game HUD scaling.
+ INI configuration saving.
+ HUD preview mode.

[NOTES]
- Stable Release.
- Further testing and adjustments may be required.


================================================================
17. DISCLAIMER
================================================================

Parking Sensor merupakan modifikasi tidak resmi
untuk Grand Theft Auto: San Andreas dan SA-MP.

Mod ini tidak berafiliasi secara resmi dengan Rockstar
Games maupun pengembang SA-MP.

Seluruh merek dagang dan hak atas game tetap menjadi
milik pemegang hak masing-masing.

Penggunaan mod merupakan tanggung jawab pengguna.

Pastikan penggunaan mod sesuai dengan aturan server
tempat Anda bermain.

Dilarang mengklaim karya pihak lain sebagai milik sendiri.
Untuk redistribusi atau modifikasi, ikuti ketentuan lisensi
yang ditetapkan oleh pemilik mod dan aset terkait.


================================================================
                     END OF README
================================================================